home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / ttyname.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  60 lines
  1.  
  2. TTYNAME(3)                 UNIX Programmer's Manual                 TTYNAME(3)
  3.  
  4. NNAAMMEE
  5.      ttttyynnaammee, iissaattttyy, ttttyysslloott - get name of associated terminal (tty) from
  6.      file descriptor
  7.  
  8. SSYYNNOOPPSSIISS
  9.      ##iinncclluuddee <<uunniissttdd..hh>>
  10.  
  11.      _c_h_a_r _*
  12.      ttttyynnaammee(_i_n_t _f_d)
  13.  
  14.      _i_n_t
  15.      iissaattttyy(_i_n_t _f_d)
  16.  
  17.      _i_n_t
  18.      ttttyysslloott()
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      These functions operate on the system file descriptors for terminal type
  22.      devices. These descriptors are not related to the standard I/O FILE type-
  23.      def, but refer to the special device files found in _/_d_e_v and named
  24.      _/_d_e_v_/_t_t_y_x_x and for which an entry exists in the initialization file
  25.      _/_e_t_c_/_t_t_y_s_. (See ttys(5).)
  26.  
  27.      The iissaattttyy() function determines if the file descriptor _f_d refers to a
  28.      valid terminal type device.
  29.  
  30.      The ttttyynnaammee() function gets the related device name of a file descriptor
  31.      for which iissaattttyy() is true
  32.  
  33.      The ttttyysslloott() function fetches the current process' control terminal num-
  34.      ber from the ttys(5) file entry.
  35.  
  36. RREETTUURRNN VVAALLUUEESS
  37.      The ttttyynnaammee() function returns the null terminated name if the device is
  38.      found and iissaattttyy() is true; otherwise a NULL pointer is returned.
  39.  
  40.      The ttttyysslloott() function returns the unit number of the device file if
  41.      found; otherwise the value zero is returned.
  42.  
  43. FFIILLEESS
  44.      /dev/*
  45.      /etc/ttys
  46.  
  47. SSEEEE AALLSSOO
  48.      ioctl(2),  ttys(5)
  49.  
  50. HHIISSTTOORRYY
  51.      A iissaattttyy(), ttttyynnaammee(), and ttttyysslloott() function appeared in Version 7 AT&T
  52.      UNIX.
  53.  
  54. BBUUGGSS
  55.      The ttttyynnaammee() function leaves its result in an internal static object and
  56.      returns a pointer to that object. Subsequent calls to ttttyynnaammee() will mod-
  57.      ify the same object.
  58.  
  59. BSD Experimental                 June 4, 1993                                1
  60.